home *** CD-ROM | disk | FTP | other *** search
/ Resource Library: Multimedia / Resource Library: Multimedia.iso / archvrs / msdos / lzeshl / lzeshell.doc next >
Encoding:
Text File  |  1990-03-15  |  6.0 KB  |  118 lines
  1.                                  LZESHELL.EXE
  2.                                  Version 1.01
  3.  
  4.      ┌───────────────────────────────────────────────────────────────────┐
  5.      │  An English language shell program for running Fabrice Bellard's  │
  6.      │   LZEXE file compression utility for EXE files.  Also runs his    │
  7.      │      UPACKEXE program for unpacking EXE files that have been      │
  8.      │     processed with Microsoft's EXEPACK utility, so LZEXE can      │
  9.      │                  achieve maximum compression.                     │
  10.      └───────────────────────────────────────────────────────────────────┘
  11.  
  12.                       Document revised March 14, 1990
  13.  
  14.  (The only differences between version 1.01 of LZESHELL and the first release,
  15.         Version 1.00, are minor fixes for some of the screen messages.)
  16.  
  17.  
  18. AUTHOR:  Pete Petrakis, CIS 76555,1175
  19.  
  20.  
  21. DESCRIPTION
  22.  
  23. This program is designed to work only with version 0.91 of LZEXE, a utility
  24. that can compress EXE files substantially while leaving them executable.  The
  25. compressions LZEXE achieves are usually in the range of 30 to 40 percent,
  26. although they are often higher than that.  Programs compressed with LZEXE
  27. decompress themselves when they are run.  The decompression time is negligible.
  28. LZEXE was written by Fabrice Bellard, of Grabels, France and is still under
  29. development.  It is a free program, but Mr. Bellard retains the copyright.
  30.  
  31.   Version 0.91 of LZEXE overcomes version 0.90's problem of excessive load
  32. memory size for compressed files.  The compressed files now take about the same
  33. amount of memory to load as they did before compression.  For this reason my
  34. previous shell program LZEFIX, which ran Microsoft's EXEMOD header utility
  35. to reduce the excessive load sizes created by version 0.90, should not be used
  36. with version 0.91.  It isn't needed.  In fact it could cause problems
  37. (including having to reboot your system) if you try to use it with this newer
  38. version of LZEXE.  Accordingly, LZESHELL makes no adjustment to the headers of
  39. compressed EXE files.
  40.  
  41.   Unlike the previous version of LZEXE, version 0.91 prompts, in French, for
  42. user input, depending on what it finds out about the file you have asked it
  43. to compress.  LZESHELL translates the prompts into English (the translation
  44. is not literal).  That's not all it does, however.
  45.  
  46.   LZESHELL also automates the use of two of Bellard's utilities:  LZEXE v0.91,
  47. of course, and a new program he has written called UPACKEXE v1.00.  UPACKEXE
  48. unpacks EXE files that have been compressed with Microsoft's EXEPACK utility.
  49. Unpacking such files allows LZEXE to do an even better compression job.
  50.  
  51.   Version 0.91 of LZEXE can detect files that have been EXEPACKed.  When it
  52. does, it tells you so and asks whether it should continue the compression or
  53. quit so you can run UPACKEXE first.  In that situation, you would normally end
  54. up running two programs manually.  When you use LZESHELL, however, you
  55. don't have to quit if you want to use UPACKEXE.  LZESHELL translates the
  56. prompt into English, and if your response is that you want to unpack the file
  57. before compressing it, it immediately runs UPACKEXE.  Then it runs LZEXE again
  58. to complete the compression.  In other words, you don't go back to DOS until
  59. both programs have been run.  The effect is to make these two fine utilities
  60. act as a single program.
  61.  
  62.   Both UPACKEXE and LZEXE save source files as backups, changing their names
  63. to *.OLD.  This can create a problem when you run UPACKEXE then run LZEXE.
  64. The *.OLD backup file saved by UPACKEXE will be replaced by the *.OLD file
  65. saved by LZEXE -- you end up losing the EXEPACKed *.OLD file.  LZESHELL
  66. eliminates this problem by immediately renaming the *.OLD file produced by
  67. UPACKEXE to *.OPK.  This leaves you with two backup files -- one for the
  68. original EXEPACKed file (*.OPK) and one for the unpacked file (*.OLD).  The
  69. third file will be your compressed EXE file.  If the compressed file works,
  70. you can remove both backup files from your disk.  Otherwise, you can erase
  71. the compressed EXE file and rename one of the backups to *.EXE (probably the
  72. EXEPACKed one, *.OPK, since it's the original and it's smaller).
  73.  
  74.   LZESHELL also generates English prompts for another situation that LZEXE
  75. v.0.91 detects, namely the use of overlays by the EXE file.  Here you are
  76. given the choice of aborting the compression or continuing it (taking the
  77. chance that the compressed file won't work).  UPACKEXE v1.00 detects
  78. "internal" overlays (I'm not sure what those are), but in that situation it
  79. only issues a warning and requires no user choices.  LZESHELL translates the
  80. warning into English.
  81.  
  82.   Finally, LZESHELL readjusts the timestamp on a processed file so it's
  83. the same as it was in the original file.  When LZEXE and UPACKEXE are run
  84. by themselves they always give the new file the current date, which some
  85. people feel is a shortcoming since it obliterates a useful identifier.
  86.  
  87.  
  88. RUNNING THE PROGRAM
  89.  
  90. LZESHELL, LZEXE (v.0.91), and UPACKEXE (v1.00), or their directories, should
  91. be on your system's path (use the DOS PATH command to do this, preferably in
  92. an AUTOEXEC.BAT file).  This will allow you move freely from directory to
  93. directory to compress EXE files.  You should always go to the directory of
  94. the file you want to compress.
  95.  
  96.   To run the program type the following at the DOS prompt:
  97.  
  98.               LZESHELL [EXE file to be compressed]
  99.  
  100.   Translated warnings and prompts will appear in a box on your screen.  At the
  101. end of the compression a "scorecard" will appear showing you the file size
  102. before and after compression, the size reduction in bytes, and the percent
  103. reduction.
  104.  
  105.  
  106. DISTRIBUTION 
  107.  
  108. LZESHELL may be freely distributed provided it's not modified and no money
  109. is charged for it. 
  110.  
  111.  
  112. DISCLAIMER 
  113.  
  114. Pete Petrakis accepts no responsibility or liability for any mishap 
  115. resulting from the use of LZESHELL.  To protect yourself against loss of
  116. valuable files you are advised to keep backups in a safe place or to check
  117. the performance of compressed files thoroughly before discarding their backups.
  118.